Skip to content

docs: Inference Providers integration guide billing#2583

Merged
SBrandeis merged 1 commit into
mainfrom
clarify-provider-billing-docs
Jun 23, 2026
Merged

docs: Inference Providers integration guide billing#2583
SBrandeis merged 1 commit into
mainfrom
clarify-provider-billing-docs

Conversation

@SBrandeis

@SBrandeis SBrandeis commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Note

Low Risk
Markdown-only changes to provider onboarding docs; no runtime or billing code is modified.

Overview
Expands the Billing section in register-as-a-provider.md so inference partners can implement and operate the cost callback API with clearer expectations.

Adds How billing works (placeholder usage → minute polling → real cost replacement) and stresses that users are only charged after the provider returns a cost.

Documents billing API response rules (partial batches, { "requests": null }, ignore unknown IDs), Price unit edge cases (0, round-up, invalid values), Timing and retries (1-minute batches, optional delay, idempotency, ~30-minute give-up with no user charge), and Which requests we ask about (2xx/3xx only). Also requires the billing Inference-Id (or equivalent) header on every response, including streaming.

Reviewed by Cursor Bugbot for commit 2a01fc5. Bugbot is set up for automated code reviews on this repo. Configure here.

@HuggingFaceDocBuilderDev

Copy link
Copy Markdown

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@hanouticelina hanouticelina left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@SBrandeis
SBrandeis merged commit df077a1 into main Jun 23, 2026
3 checks passed
@SBrandeis
SBrandeis deleted the clarify-provider-billing-docs branch June 23, 2026 11:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants